home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / mail / sendmail / sendmail-5.65c+IDA-1.4.4.1 / src / RCS / sendmail.8,v < prev    next >
Encoding:
Text File  |  1991-06-05  |  10.9 KB  |  496 lines

  1. head    6.3;
  2. branch    6.3.0;
  3. access;
  4. symbols
  5.     BETA:6.3.0.1
  6.     UICSO:6.3.0
  7.     VANILLA:6.3;
  8. locks; strict;
  9.  
  10.  
  11. 6.3
  12. date    90.06.20.08.36.27;    author paul;    state Exp;
  13. branches
  14.     6.3.0.1;
  15. next    ;
  16.  
  17. 6.3.0.1
  18. date    91.06.02.04.18.41;    author paul;    state Exp;
  19. branches;
  20. next    ;
  21.  
  22.  
  23. desc
  24. @@
  25.  
  26.  
  27.  
  28. 6.3
  29. log
  30. @5.64 Berkeley release
  31. @
  32. text
  33. @.\" Copyright (c) 1988 The Regents of the University of California.
  34. .\" All rights reserved.
  35. .\"
  36. .\" Redistribution and use in source and binary forms are permitted
  37. .\" provided that the above copyright notice and this paragraph are
  38. .\" duplicated in all such forms and that any documentation,
  39. .\" advertising materials, and other materials related to such
  40. .\" distribution and use acknowledge that the software was developed
  41. .\" by the University of California, Berkeley.  The name of the
  42. .\" University may not be used to endorse or promote products derived
  43. .\" from this software without specific prior written permission.
  44. .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
  45. .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  46. .\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  47. .\"
  48. .\"    @@(#)sendmail.8    6.3 (Berkeley) 9/20/88
  49. .\"
  50. .TH SENDMAIL 8 "September 20, 1988"
  51. .UC 4
  52. .SH NAME
  53. sendmail \- send mail over the internet
  54. .SH SYNOPSIS
  55. .B /usr/lib/sendmail
  56. [
  57. flags
  58. ] [
  59. address ...
  60. ]
  61. .PP
  62. .B newaliases
  63. .PP
  64. .B mailq
  65. [
  66. .B \-v
  67. ]
  68. .SH DESCRIPTION
  69. .I Sendmail
  70. sends a message to one or more
  71. .IR recipients ,
  72. routing the message over whatever networks
  73. are necessary.
  74. .I Sendmail
  75. does internetwork forwarding as necessary
  76. to deliver the message to the correct place.
  77. .PP
  78. .I Sendmail
  79. is not intended as a user interface routine;
  80. other programs provide user-friendly
  81. front ends;
  82. .I sendmail
  83. is used only to deliver pre-formatted messages.
  84. .PP
  85. With no flags,
  86. .I sendmail
  87. reads its standard input
  88. up to an end-of-file
  89. or a line consisting only of a single dot
  90. and sends a copy of the message found there
  91. to all of the addresses listed.
  92. It determines the network(s) to use
  93. based on the syntax and contents of the addresses.
  94. .PP
  95. Local addresses are looked up in a file
  96. and aliased appropriately.
  97. Aliasing can be prevented by preceding the address
  98. with a backslash.
  99. Normally the sender is not included in any alias
  100. expansions, e.g.,
  101. if `john' sends to `group',
  102. and `group' includes `john' in the expansion,
  103. then the letter will not be delivered to `john'.
  104. .PP
  105. Flags are:
  106. .TP 1.2i
  107. .B \-ba
  108. Go into \s-1ARPANET\s0 mode.
  109. All input lines must end with a CR-LF,
  110. and all messages will be generated with a CR-LF at the end.
  111. Also,
  112. the ``From:'' and ``Sender:''
  113. fields are examined for the name of the sender.
  114. .TP 1.2i
  115. .B \-bd
  116. Run as a daemon.  This requires Berkeley IPC.
  117. .I Sendmail
  118. will fork and run in background
  119. listening on socket 25 for incoming SMTP connections.
  120. This is normally run from
  121. .IR /etc/rc .
  122. .TP 1.2i
  123. .B \-bi
  124. Initialize the alias database.
  125. .TP 1.2i
  126. .B \-bm
  127. Deliver mail in the usual way (default).
  128. .TP 1.2i
  129. .B \-bp
  130. Print a listing of the queue.
  131. .TP 1.2i
  132. .B \-bs
  133. Use the \s-2SMTP\s0 protocol as described in RFC821
  134. on standard input and output.
  135. This flag implies all the operations of the
  136. .B \-ba
  137. flag that are compatible with \s-2SMTP\s0.
  138. .TP 1.2i
  139. .B \-bt
  140. Run in address test mode.
  141. This mode reads addresses and shows the steps in parsing;
  142. it is used for debugging configuration tables.
  143. .TP 1.2i
  144. .B \-bv
  145. Verify names only \- do not try to collect or deliver a message.
  146. Verify mode is normally used for validating
  147. users or mailing lists.
  148. .TP 1.2i
  149. .B \-bz
  150. Create the configuration freeze file.
  151. .TP 1.2i
  152. .BI \-C file
  153. Use alternate configuration file.
  154. .I Sendmail
  155. refuses to run as root if an alternate configuration file is specified.
  156. The frozen configuration file is bypassed.
  157. .TP 1.2i
  158. .BI \-d X
  159. Set debugging value to
  160. .I X.
  161. .TP 1.2i
  162. .BI \-F fullname
  163. Set the full name of the sender.
  164. .TP 1.2i
  165. .BI \-f name
  166. Sets the name of the ``from'' person
  167. (i.e., the sender of the mail).
  168. .B \-f
  169. can only be used
  170. by ``trusted'' users
  171. (normally
  172. .I root,
  173. .I daemon,
  174. and
  175. .I network)
  176. or if the person you are trying to become
  177. is the same as the person you are.
  178. .TP 1.2i
  179. .BI \-h N
  180. Set the hop count to
  181. .I N.
  182. The hop count is incremented every time the mail is
  183. processed.
  184. When it reaches a limit,
  185. the mail is returned with an error message,
  186. the victim of an aliasing loop.
  187. If not specified,
  188. ``Received:'' lines in the message are counted.
  189. .TP 1.2i
  190. .B \-n
  191. Don't do aliasing.
  192. .TP 1.2i
  193. .BI \-o x\|value
  194. Set option
  195. .I x
  196. to the specified
  197. .I value.
  198. Options are described below.
  199. .TP 1.2i
  200. .BI \-q[ time ]
  201. Processed saved messages in the queue at given intervals.
  202. If
  203. .I time
  204. is omitted,
  205. process the queue once.
  206. .I Time
  207. is given as a tagged number,
  208. with `s' being seconds,
  209. `m' being minutes,
  210. `h' being hours,
  211. `d' being days,
  212. and
  213. `w' being weeks.
  214. For example,
  215. ``\-q1h30m'' or ``\-q90m''
  216. would both set the timeout to one hour thirty minutes.
  217. If
  218. .I time
  219. is specified,
  220. .I sendmail
  221. will run in background.
  222. This option can be used safely with
  223. .BR \-bd .
  224. .TP 1.2i
  225. .BI \-r name
  226. An alternate and obsolete form of the
  227. .B \-f
  228. flag.
  229. .TP 1.2i
  230. .B \-t
  231. Read message for recipients.
  232. To:, Cc:, and Bcc: lines will be scanned for recipient addresses.
  233. The Bcc: line will be deleted before transmission.
  234. Any addresses in the argument list will be suppressed,
  235. that is,
  236. they will
  237. .I not
  238. receive copies even if listed in the message header.
  239. .TP 1.2i
  240. .B \-v
  241. Go into verbose mode.
  242. Alias expansions will be announced, etc.
  243. .PP
  244. There are also a number of processing options that may be set.
  245. Normally these will only be used by a system administrator.
  246. Options may be set either on the command line
  247. using the
  248. .B \-o
  249. flag
  250. or in the configuration file.
  251. These are described in detail in the
  252. .ul
  253. Sendmail Installation and Operation Guide.
  254. The options are:
  255. .TP 1.2i
  256. .RI A file
  257. Use alternate alias file.
  258. .TP 1.2i
  259. c
  260. On mailers that are considered ``expensive'' to connect to,
  261. don't initiate immediate connection.
  262. This requires queueing.
  263. .TP 1.2i
  264. .RI d x
  265. Set the delivery mode to
  266. .I x.
  267. Delivery modes are
  268. `i' for interactive (synchronous) delivery,
  269. `b' for background (asynchronous) delivery,
  270. and
  271. `q' for queue only \- i.e.,
  272. actual delivery is done the next time the queue is run.
  273. .TP 1.2i
  274. D
  275. Try to automatically rebuild the alias database
  276. if necessary.
  277. .TP 1.2i
  278. .RI e x
  279. Set error processing to mode
  280. .I x.
  281. Valid modes are
  282. `m' to mail back the error message,
  283. `w' to ``write'' back the error message
  284. (or mail it back if the sender is not logged in),
  285. `p' to print the errors on the terminal
  286. (default),
  287. `q' to throw away error messages
  288. (only exit status is returned),
  289. and `e'
  290. to do special processing for the BerkNet.
  291. If the text of the message is not mailed back
  292. by
  293. modes `m' or `w'
  294. and if the sender is local to this machine,
  295. a copy of the message is appended to the file
  296. ``dead.letter''
  297. in the sender's home directory.
  298. .TP 1.2i
  299. .RI F mode
  300. The mode to use when creating temporary files.
  301. .TP 1.2i
  302. f
  303. Save UNIX-style From lines at the front of messages.
  304. .TP 1.2i
  305. .RI g N
  306. The default group id to use when calling mailers.
  307. .TP 1.2i
  308. .RI H file
  309. The SMTP help file.
  310. .TP 1.2i
  311. i
  312. Do not take dots on a line by themselves
  313. as a message terminator.
  314. .TP 1.2i
  315. .RI L n
  316. The log level.
  317. .TP 1.2i
  318. m
  319. Send to ``me'' (the sender) also if I am in an alias expansion.
  320. .TP 1.2i
  321. o
  322. If set, this message may have
  323. old style headers.
  324. If not set,
  325. this message is guaranteed to have new style headers
  326. (i.e., commas instead of spaces between addresses).
  327. If set, an adaptive algorithm is used that will correctly
  328. determine the header format in most cases.
  329. .TP 1.2i
  330. .RI Q queuedir
  331. Select the directory in which to queue messages.
  332. .TP 1.2i
  333. .RI r timeout
  334. The timeout on reads;
  335. if none is set,
  336. .I sendmail
  337. will wait forever for a mailer.
  338. This option violates the word (if not the intent) of the SMTP specification,
  339. show the timeout should probably be fairly large.
  340. .TP 1.2i
  341. .RI S file
  342. Save statistics in the named file.
  343. .TP 1.2i
  344. s
  345. Always instantiate the queue file,
  346. even under circumstances where it is not strictly necessary.
  347. This provides safety against system crashes during delivery.
  348. .TP 1.2i
  349. .RI T time
  350. Set the timeout on undelivered messages in the queue to the specified time.
  351. After delivery has failed
  352. (e.g., because of a host being down)
  353. for this amount of time,
  354. failed messages will be returned to the sender.
  355. The default is three days.
  356. .TP 1.2i
  357. .RI t stz,dtz
  358. Set the name of the time zone.
  359. .TP 1.2i
  360. .RI u N
  361. Set the default user id for mailers.
  362. .PP
  363. In aliases,
  364. the first character of a name may be
  365. a vertical bar to cause interpretation of
  366. the rest of the name as a command
  367. to pipe the mail to.
  368. It may be necessary to quote the name
  369. to keep
  370. .I sendmail
  371. from suppressing the blanks from between arguments.
  372. For example, a common alias is:
  373. .PP
  374.     msgs: "|/usr/ucb/msgs -s"
  375. .PP
  376. Aliases may also have the syntax ``:include:\c
  377. .IR filename ''
  378. to ask
  379. .I sendmail
  380. to read the named file for a list of recipients.
  381. For example, an alias such as:
  382. .PP
  383.     poets: ":include:/usr/local/lib/poets.list"
  384. .PP
  385. would read
  386. .I /usr/local/lib/poets.list
  387. for the list of addresses making up the group.
  388. .PP
  389. .I Sendmail
  390. returns an exit status
  391. describing what it did.
  392. The codes are defined in
  393. .RI < sysexits.h >
  394. .ta 3n +\w'EX_UNAVAILABLE'u+3n
  395. .de XX
  396. .ti \n(.iu
  397. ..
  398. .in +\w'EX_UNAVAILABLE'u+6n
  399. .XX
  400.      EX_OK    Successful completion on all addresses.
  401. .XX
  402.      EX_NOUSER    User name not recognized.
  403. .XX
  404.      EX_UNAVAILABLE    Catchall meaning necessary resources
  405. were not available.
  406. .XX
  407.      EX_SYNTAX    Syntax error in address.
  408. .XX
  409.      EX_SOFTWARE    Internal software error,
  410. including bad arguments.
  411. .XX
  412.      EX_OSERR    Temporary operating system error,
  413. such as \*(lqcannot fork\*(rq.
  414. .XX
  415.      EX_NOHOST    Host name not recognized.
  416. .XX
  417.     EX_TEMPFAIL    Message could not be sent immediately,
  418. but was queued.
  419. .PP
  420. If invoked as
  421. .I newaliases,
  422. .I sendmail
  423. will rebuild the alias database.
  424. If invoked as
  425. .I mailq,
  426. .I sendmail
  427. will print the contents of the mail queue.
  428. .SH FILES
  429. Except for
  430. /usr/lib/sendmail.cf,
  431. these pathnames are all specified in
  432. /usr/lib/sendmail.cf.
  433. Thus,
  434. these values are only approximations.
  435. .PP
  436. .if t .ta 2i
  437. .if n .ta 3i
  438. /usr/lib/aliases    raw data for alias names
  439. .br
  440. /usr/lib/aliases.pag
  441. .br
  442. /usr/lib/aliases.dir    data base of alias names
  443. .br
  444. /usr/lib/sendmail.cf    configuration file
  445. .br
  446. /usr/lib/sendmail.fc    frozen configuration
  447. .br
  448. /usr/lib/sendmail.hf    help file
  449. .br
  450. /usr/lib/sendmail.st    collected statistics
  451. .br
  452. /usr/spool/mqueue/*    temp files
  453. .SH SEE\ ALSO
  454. binmail(1), mail(1), rmail(1), syslog(3),
  455. aliases(5), mailaddr(7), rc(8);
  456. .br
  457. DARPA Internet Request For Comments
  458. RFC819, RFC821, RFC822;
  459. .br
  460. .ul
  461. Sendmail \- An Internetwork Mail Router
  462. (SMM:16);
  463. .br
  464. .ul
  465. Sendmail Installation and Operation Guide
  466. (SMM:7)
  467. @
  468.  
  469.  
  470. 6.3.0.1
  471. log
  472. @Added -M, -R, -S flags to select queued messages based on queue-id,
  473. recipient, or sender address.
  474. @
  475. text
  476. @a106 3
  477. .B \-bb
  478. Read batched SMTP (BSMTP) commands from standard input.
  479. .TP 1.2i
  480. a191 14
  481. .TP 1.2i
  482. .BI \-M ident
  483. Process the queued message with the queue id
  484. .IR ident .
  485. .TP 1.2i
  486. .BI \-R addr
  487. Process the queued messages that have the string
  488. .I addr
  489. in one of the recipient addresses.
  490. .TP 1.2i
  491. .BI \-S addr
  492. Process the queued messages that have the string
  493. .I addr
  494. in the sender address.
  495. @
  496.